home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Medal Software 3
/
Gold Medal Software - Volume 3 (Gold Medal) (1994).iso
/
comms
/
bcom09cb.arj
/
BCOM.DOC
next >
Wrap
Text File
|
1994-01-20
|
25KB
|
572 lines
BananaCom will help you to start using your modem.
BananaCom does not require you to specify parity, data bits,
stop bits, echo, duplex, terminal emulation, flow control, etc.
General practice has made it clear that most of this has been
standardized and the need for variation is rare.
BananaCom does not require megabytes of memory or disk space.
In fact, BananaCom can easily run from a 360k disk and have room for
file transfers on the same disk! BananaCom will give ZModem, ANSI
and high speed capability to some of the most feeble computers.
First time configuration of BananaCom usually takes under a minute.
Alt-M will show you a menu and list the "Alt" commands.
Note that with "Alt" commands, you use the Alt key like a shift key:
For Alt-M, hold down your alt key and tap your M key once.
"Alt" commands only work from the main terminal screen.
The latest version of BananaCom can be found on
The Montana Banana BBS (406)543-8234
(use your arrow keys to see the rest of this information)
BananaCom is free for private use.
Registration of $20 will get you voice phone support.
Commercial, non-profit and government users must register.
Site license rates available.
Make checks and money orders payable to Paul Wheaton and mail to:
Paul Wheaton 1916 Brooks #205 Missoula, MT 59801
Visa or M/C orders can be called in to (406)543-1928
BananaCom is a Banana Programming product.
Call for your custom programming needs.
Getting started with BananaCom
After you have your modem and BananaCom properly configured, getting
connected to your favorite modem service should take just a few
seconds.
The first step is to configure your "COM port" (also called your
"serial port"). if you know what COM port your modem uses, tap Alt-P
until the appropriate COM number appears at the bottom of your
screen.
If you don't know what COM port your modem uses, press Alt-V to
verify your current COM port setting. If "OK" appears, your COM
port is now properly configured! Otherwise, press Alt-P to change
your port number and then try Alt-V again. Repeat until you see
"OK" or have tried all the ports and nothing happens (in which case,
see "Troubleshooting" below).
If your modem is connected to a phone line where you have to "dial 9
to get out", press Alt-M and then select "modify dialing
prefix/suffix". Change the prefix to "ATDT9," and then press F2.
Make sure your modem is plugged in to a working phone line. Press
Alt-D for the Dialing Directory. Use the up and down arrow keys to
select a modem service. When the service you want to dial is
highlighted, press your enter key. If your modem's speaker is
turned on, you should hear dial tone, dialing, ringing, a whistling
sound, a kind of harsh static and then silence. Within ten
to thirty seconds your modem should report "CONNECT". At this time
you follow the instructions of operation for your modem service.
Sometimes you need to tap your enter key a few times to get things
rolling. Between the time that you press enter to select the modem
service you want to dial, and the time you get the "CONNECT"
message, pressing any key will stop the call and you will get a "NO
CARRIER" message.
Using BananaCom
BananaCom may be run from any directory on any DOS disk-type device.
Just make sure that you have BCOM.EXE and BCOM.DOC in the current
directory before you type BCOM to start BananaCom.
When BananaCom is started, you are immediately put into the "main
terminal screen" - this means that BananaCom is now forcing your
computer to behave like a terminal. The bottom line tells you some
information about the current BananaCom settings and will try to
direct you to keys that will help you do things. The rest of the
screen is the space that your favorite modem service will use to
dazzle you!
Note that for any menu in BananaCom (this includes the dialing
directory), you may press your escape key to exit and do nothing.
If you are in a BananaCom editing screen, you may press your escape
key to exit and any changes you made will be ignored. As with many
programs, your escape key helps you to "back up" or "get out" of
things. The only time that escape will not give you this effect is
at the main terminal screen. The reason is that the escape key is
often used to be passed to a modem service. Instead, you must use
Alt-X (to exit BananaCom).
Dialing Directory (Alt-D)
To call a modem service, you tell your modem what the phone number
of the service is and it will do the dialing. Since most folks
can't remember the phone numbers for all the modem services they
use, we have provided a dialing directory. You press Alt-D and then
use your cursor (arrow) keys (your home, end, page up, page down
and alphabet (A to Z) keys will work too) to highlight the modem
service that you want to call, press return and BananaCom will feed
your modem the appropriate phone number.
Note that it will take a few seconds for your modem to dial up and
connect with the modem for the service. Pressing extra keys does
not speed things up, it hangs up the phone! Some people seem to do
this without being aware of it!
If you have the phone number for a modem service that you want to
add to the dialing directory, press Alt-D, go to the bottom of the
directory and press your enter key. Fill in the fields for the name
and phone number for the service (be sure that the phone number is
the modem number and not a voice or fax number!). For the "speed"
field, use your + (plus key), - (minus key) and space bar to select
the most appropriate speed (you may press your F3 key to select the
speed with a menu). If you are not sure what speed to pick, start
with 2400bps (or slower if your modem is a slower modem) and try
faster speeds later. When the name, number and speed all look
correct to you, press your F2 key to save the changes.
When the dialing directory is on the screen, you may press your
Alt-R key to revise an entry.
Note that if you have a very long phone number such as
10288,,,406-543-8234,,,40654382349999 (interpretation: use AT&T;
pause; number to dial; pause; calling card number) that the number
might overwrite part of your modem service name.
Main Menu (Alt-M)
The menu will show you all of the "ALT" commands available plus any
other commands that don't get used often enough to warrant an "Alt"
command. Essentially, all of the functionality of BananaCom can be
accessed through the main menu!
ZModem
Most modem services offer a collection of files that people may
download. A "file transfer protocol" is a technique that both the
terminal software (BananaCom) and the host software (the modem
service or BBS) agree upon for copying a file from one to the other.
There are usually a dozen or more file transfer protocols available
on most systems. The most popular is ZModem.
Downloading: Once you are connected to a modem service and have
specified to the service one or more files that you want to download
via ZModem, the service will send some special characters to
BananaCom that will begin a ZModem download. BananaCom will then
put a box in the top-right corner of your screen and show you the
progress of the file transfer. When an exact copy of the file is in
the current directory of your computer (the same directory that
BananaCom is in), the box will be taken away and you will be able to
continue with using your modem service. When your modem service
session is over, you can exit from BananaCom (with Alt-X) and work
with your downloaded file just as you would with any other file on
your computer!
Uploading: When you tell your modem service that you want to
upload via ZModem, it will send some text that will alert BananaCom
to ask you for a file name. After you have typed in the file name,
press return and the upload will begin. If your modem service is an
odd duck, it might not send the appropriate characters and instead,
wait dumbly for you to send these characters. If this happens,
press Alt-M and select "ZModem Upload".
Exit (Alt-X)
Terminates the BananaCom program. If you happened to be on-line,
the modem will be hung up.
Hang Up (Alt-H)
When you are ready to end a call to a modem service, the best thing
to do is to follow the instructions of the service for terminating
the call. If you seem to be stuck or cannot find a way to have the
service terminate the call, type Alt-H to hang up the phone on your
end.
Verify Configuration (Alt-V)
When you press Alt-V, BananaCom will send a command to your modem
that should work on almost all modems. If the port and speed are
set properly, the modem will put "OK" on the screen. This is a
signal that you are now ready to make calls.
Note that some modems have been programmed so that when they come
on, they will behave in a non-standard manner. This may make your
modem work better with BananaCom or it may make it not work at all
with BananaCom. If you use BananaCom later and find that things
don't seem to be working, try Alt-V again. If things then work,
look in your modem manual to see if there is a way to get your modem
to remember what you told it with Alt-V (on some modems, you would
type "AT&W"). Otherwise, you might want to put the commands from
Alt-V into your dialing prefix. See "Edit dialing prefix and
suffix" later in this documentation.
DOS Shell (Alt-S)
Sometimes when you are using a modem service, you need to pop out to
DOS and do something real quick. Press Alt-S and you will see the
DOS prompt. Do what you need to do and make sure that you end up
with the same "current directory" that you started with. Type
EXIT and then press enter. It will look like you never left!
Rate (or speed) (Alt-R)
This is how fast BananaCom talks to your COM port (technically, the
DTE speed). Sometimes, this is faster than your modem speed. This
is the speed that is shown at the bottom of your screen when you
first start BananaCom. It is the default speed for when you add
modem services to the dialing directory. It is the speed that is
used for everything you do before you use the dialing directory.
As a rule of thumb, you set this to be the speed of your modem. If
your modem has "data compression" you set it for the next higher
speed. HOWEVER, you should not set this to higher than 9600 if your
serial port won't go that fast.
Example 1: You have a plain 2400bps modem. Set your rate to
2400bps.
Example 2: You have a 14,400bps internal modem that supports data
compression and has a built in 16550NA chip. Set your rate to
19,200bps.
Example 3: You have a 14,400bps external modem that supports
data compression, but your serial port does not have a 16550NA
chip. Set your rate to 9,600bps.
Note that internal modems requiring speeds faster than 9600bps
generally have a 16550NA or equivalent chip. If you have an
external modem and want to set the rate to something higher than
9600bps AND do not know if you have a 16550NA chip, see
"Troubleshooting" below.
Clear Screen (Alt-C)
Clears the screen and sets the current color to be Yellow on Black.
Toggle Text Capture (Alt-T)
Tap Alt-T once. Now all of the new text that appears on the screen
will be stored to the file CAPTURE.TXT. If CAPTURE.TXT already had
some stuff in it, the new stuff that appears on your screen will be
appended to the end. Tap Alt-T again and text capture will stop.
Special features:
o all ANSI sequences are stripped and not in the file.
o the current date and time are put into the file each time
you tap Alt-T.
o all ANSI sequences are still processed.
o you may delete or edit the file CAPTURE.TXT at any time. The
next time you tap Alt-T, a new CAPTURE.TXT will be created.
This is especially useful if you want to print something from a
modem service. Capture what you want to print and load CAPTURE.TXT
into your favorite word processor. Now you can edit and print just
as you would any other document.
Note that text capture starts the second that you tap Alt-T.
Anything that was already on the screen when you tapped Alt-T did
not get stored.
Upload Text (Alt-U)
Usually a text upload is so you may compose a message off-line and
upload it quickly when on-line.
When you have prepared your modem service to receive a message, type
Alt-U and provide the name of your text file. BananaCom will pass
the message very quickly in a standard text upload format acceptable
on most modem services. The modem service will have no idea that
there is a text upload in progress - it will think you are a very
fast typist!
Back scroll terminal screen (Alt-B)
Sometimes when using a modem service, you find that information has
scrolled past that you need. To look at that information again,
press Alt-B. You can now use your cursor keys (up arrow, down
arrow, page up, page down, home and end) to view the text that has
passed in the last few minutes. How much text is saved depends on
how much memory you have available.
Edit Dialing Prefix and Suffix
This feature can only be accessed through the menu.
Note! The following instructions are for modems that use the "Hayes
compatible" or "AT" command set. All instructions to the
modem begin with "AT" (meaning "attention!"). "ATD" means
"dial the following number". "ATDT" means "dial the
following number with touch tone".
The dialing prefix is the command that is passed to the modem before
every modem call. Usually, it is set to ATDT although you may
need to modify it. Use:
ATDP if your phone does not support "touch tone"
ATDT9, to "dial 9 to get out"
ATDT*70, to temporarily turn off call waiting
You might also want to insert another command or two depending on
what your modem may need to work properly:
M0 turns the speaker off
M1 turns the speaker on while dialing
M1L2 turns the speaker on "loud" while dialing
M1L0 turns the speaker on "quiet" while dialing
E1 so you can see what the autodialer sends to the modem
Q0 so the modem can report problems and "CONNECT"
V1 so the modem will report "CONNECT" instead of "1"
Always insert these commands between the AT and the D. You may
include as many instructions as you like. e.g. ATM1L2E1Q0V1DT9,
or AT M1 L2 E1 Q0 V1 DT 9,
Note that some modems require that all of these commands be in upper
case and no spaces between commands!
Note also that most modems default to M1, L1, E1, Q0 and V1. We
recommend that you only use these if your modem seems to be an
exception to the rule.
Use of the dialing suffix is rare. If you have a phone where you
must type a "22" in after every number you dial before the call will
go through, you would make your dialing suffix ,22
Troubleshooting
The most common problem is COM port devices improperly configured.
Usually, an internal modem will be set to use COM2 and an external
serial port will also be set to use COM2. Or maybe an external
modem will be set to use the serial port COM1 and so will a mouse.
The symptoms to indicate this problem are varried. If you think
this could be your problem, you should ask your computer dealer (or
friendly computer geek) to verify that you do not have "serial port
conflicts". This process involves opening your computer and
comparing the settings of your serial devices (some of which may be
on your computer's "motherboard").
Sometimes, if a modem has two phone plugs, the modem is picky about
which plug is for the phone line that goes to the wall and which one
goes to the telephone. If you suspect this could be the problem,
swap the plugs.
External Modems
Check to make sure the serial cable is tightly connected to the
modem and your computer.
You MUST use a cable that has at least 9 wires in it (pins 1
through 8 and pin 20). While 4 wire cable is great for a lot of
terminal setups, it doesn't cut it for today's modem user!
If you are trying to go faster than 9600bps and the serial port
that your modem uses does not have a 16550A chip, you stand a good
chance of losing characters. Set your speed to 9600 and see if
things improve. If they do, call the Montana Banana BBS at
(406)543-8234 and download IS16550.ZIP - this tiny program will
tell you what your chip situation is.
Laptops
Many laptops have a power conservation method that shuts off
certain devices, such as your modem or serial port, when not in
use. See the manual that came with your laptop to find out how
you turn your serial port or modem on. Usually it is a command
that you type in at the DOS prompt.
Older modems
Newer modems have become predictable and standardized. Some older
modems will work with modern modem services, just differently. If
you suspect that you may be having difficulty with your modem
because of its age, register BananaCom and give us a call - we
have experience with a variety of older modems and may be able to
get you rolling.
Garbage on the screen
Unwanted characters on your screen could be caused by
a) a low quality modem.
b) somebody picking up the phone while you are using the modem.
c) line noise from the phone company or long distance carrier.
d) line noise from your house wiring, caused by: too much "flat
wire" - the wire the runs from the phone jack to your phone
is usually flat and acts as a sort of antennae - the more you
have, the more noise you get; phone wire that is close to a
fluorescent light fxture; phone wire that has a bad/loose
connection;
e) there is another phone, answering machine, fax machine
connected to this phone line that is somehow contributing
noise. Try unplugging all unneeded devices at the wall.
f) call waiting (or similar "services") solutions:
1) Call your phone company and permanantly cancel call
waiting
2) Temporarily cancel call waiting by changing your dialing
prefix to "ATDT*70," (most phone companies support this)
3) Have your modem hang up, pick up your phone and say
"Hello?"
Glossary
Modem
A modem is a common, inexpensive device that connects computers
together through phone lines. It takes computer signals and
converts them into sounds that can be used on a regular phone line
(and vice-versa).
Communications Software
All computers need sommunications software (like BananaCom) to
make the modem work with your computer. Usually, your computer
ignores your modem. The software will make it so that what you
type will go to the modem and what comes in from the modem will be
displayed on your screen. There is communications software
available for almost every computer ever made.
Terminal
Years ago computing was usually done by hooking up lots of "dumb
terminals" to one computer. A terminal was nothing more than a
keyboard and a screen (or printer). Without the computer, the
terminal was less useful than a calculator. When micro computers
came out, people still needed to access the data on the big
computers. Programs were then written so the micro computers could
emulate popular terminals. Those terminal emulations have
weathered the years and are now what a modem service expects to
interface with. "ANSI terminal emulation" seems to be the most
popular.
Baud/BPS
BPS (Bits per second) is a rate of speed that modems can send
information. To send the character "a" through a modem, takes 10
bits. So, to send a thousand characters will take 10,000 bits. A
1200bps modem (a fairly common speed) will pass 120 characters per
second. "Baud" can be very similar to BPS and many people are now
in the habit to use the term when they really mean "BPS".
Connect/Carrier
When your modem and a modem on the other side of the phone line
agree to communicate, this is the beginning of a "connection" (you
now have "carrier"). As long as the modems continue to exchange
information, you still have a connection. When one or both of the
modems hang up, you have lost carrier (or, lost your connection).
Technical information:
BananaCom uses
ANSI terminal emulation
ZModem file transfer protocols
no parity, 8 data bits, 1 stop bit
RTS/CTS flow control, no XON/XOFF flow control
no echo, full duplex
no CR/LF conversion (except in text uploads)
destructive backspace and direct screen writes
if BananaCom can detect a 16550A, it will turn the buffer on.
IRQ variations: BananaCom uses IRQ4 for COM3 and IRQ3 for COM4 by
default. To change this, create a file with one of these names:
"COM3IRQ2", "COM3IRQ5", "COM4IRQ2", "COM4IRQ5". Note that there
must be no extension and that it does not matter if there is
anything in the file, only the presence of the file will be tested
for.
Note that for the Alt-H (hang up) command to work, your modem must
be set so that it is sensitive to changes in DTR. Alt-H drops DTR
for one fifth of a second.
The BCOM.TXT file
This file will be generated if it does not exist. You may edit
this file if you have an appropriate text editor, knowledge and
are careful. The layout:
Line 1: speed (must be "300", "1200", "2400", "9600",
"19200", "38400", "57600" or "115200")
Line 2: COM port number (must be "1", "2", "3" or "4")
Line 3: dialing prefix (usually "ATDT")
Line 4: dialing suffix (usually blank)
The remaining lines are for the dialing directory. The format
is important - 29 characters for the name (left justified); 1
character for a space; 19 characters for a phone number (right
justified); another 1 character space; 3 to 6 characters for
the speed.
Electronic addresses:
The Montana Banana BBS: (406)543-8234 (14.4kbps with QWK)
CompuServe: 72707,207
Internet: 72707.207@compuserve.com
Legaleeze
You may distribute copies of BananaCom to friends, computer clubs,
user groups or modem services so long as
a) no fee is charged (other than a nominal media fee not to exceed
$5.00), and
b) both files (BCOM.EXE and BCOM.DOC) are included without
modification, and
c) a BCOM.TXT (containing a dialing directory) file is NOT
included without the express written consent of the author,
Paul Wheaton (this is generally done for a small fee), and
d) If BananaCom is stored in a compressed file (such as a zip
file), the name of the file, sans the extension, shall be
1) BCOM, or
2) BCOM00 where 00 would be replaced with a version number.
e.g., the file name for BananaCom version 1.2 would be BCOM12.
If you are using BananaCom from a computer that is owned by a
corporation (whether commercial, non-profit or government), or
claimed as a business expense then you MUST register BananaCom or
not use it at all.
THIS PROGRAM IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND.
THE AUTHOR DISCLAIMS ANY AND ALL OTHER WARRANTIES, EXPRESS OR
IMPLIED, ORAL OR WRITTEN, INCLUDING ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY INCIDENTAL,
CONSEQUENTIAL, OR PUNITIVE DAMAGES WHATSOEVER ARISING OUT OF USE OF
THE PROGRAM OR YOUR RELATIONSHIP WITH THE AUTHOR, INCLUDING WITHOUT
LIMITATION ANY OR ALL DAMAGES FOR LOSS OF PROFITS, BUSINESS
INTERRUPTION, LOSS OF INFORMATION OR ANY PECUNIARY LOSS, EVEN IF THE
AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.